home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr39 / easyad2b.zip / EASYADD.DOC next >
Text File  |  1995-02-24  |  15KB  |  322 lines
  1. ┌───────────────────────────────────────────────────────────────────────────┐ 
  2. │                  Copyright Notice and Program Disclaimer                  │ 
  3. └───────────────────────────────────────────────────────────────────────────┘
  4.  
  5.     The program EASYADD.EXE its support files, and this documentation file, 
  6.     are Copyright 1995, G.A.C. Computer Services.  Distribution & execution of 
  7.     the original, unaltered version is permitted, and encouraged, as long as 
  8.     all support files and documentation that accompany the program are 
  9.     included without modification in any form.
  10.  
  11.     DISCLAIMER:
  12.  
  13.     I (Gregory Campbell) make no warranty of any kind, expressed or implied,  
  14.     including without limitation any warranties of merchantability
  15.     and/or fitness for a particular purpose.  I shall not be held liable      
  16.     for any damages, whether direct, indirect, special or consequential       
  17.     arising from the failure of this program to operate in the manner desired 
  18.     by the user.  I shall not be held liable for any damage to data or        
  19.     property which may be caused directly or indirectly by the use of this    
  20.     program.
  21.  
  22.     In no event will I be held liable for any damages, including (but
  23.     not limited to) any lost profits, lost savings, or other incidental       
  24.     or consequential damages arising out of the use -- or the inability       
  25.     to use -- this program, or for any claim by any other party.
  26.  
  27. ┌───────────────────────────────────────────────────────────────────────────┐ 
  28. │                  List of included files in the Archive                    │ 
  29. └───────────────────────────────────────────────────────────────────────────┘
  30.  
  31.     EASYADD.EXE  - The Main executable
  32.     EASYADD.DOC  - This Documentation file
  33.     EASYCOLR.DAT - The Easy Address Color Configuration file
  34.     EASYUP.EXE   - Program to Update V 1.0 USER files to V 2.0 format
  35.     FILE_ID.DIZ  - A short description of Easy Address 2.0
  36.     REGISTER.DOC - A Registration form for G.A.C. Computer Services 
  37.             Products.
  38.     UPGRADE.DOC  - Step by Step Upgrade Instructions for V 1.0 SysOps        
  39.     WHATSNEW.DOC - File explaining what is new in Easy Address 2.0
  40.  
  41.     NOTE: EASYADD will make MANY small files when it executes.  
  42.  
  43.     EZ[#].ADD    - These files are created for each user in the Easy
  44.             Address directory
  45.     
  46.     EASY[#].BIN  - These files are created in the SBBS\EXEC directory
  47.  
  48. ┌───────────────────────────────────────────────────────────────────────────┐ 
  49. │                      What it does and how to use it!                      │ 
  50. └───────────────────────────────────────────────────────────────────────────┘
  51.  
  52.     NOTE: THIS PROGRAM SHOULD ONLY BE USED WITH SYNCHRONET 2.1 AND UP!
  53.  
  54.     This program is quite possibly one of the best utilities written for 
  55.     Synchronet so far.  It is an address book for use with Internet E-mail,
  56.     QWK Netmail, and Fidonet NetMail.  It should make the sysop's and 
  57.     users' experience with NetMail much easier and faster.  The following 
  58.     is a list of features:  
  59.  
  60.     - The best feature about EASY ADDRESS is that the user will simply pick 
  61.     the number of the address they want to send internet, QWK or fidonet mail 
  62.     to from a list on their screen and their message will be automatically 
  63.     addressed.  There is no longer a need to constantly type in long internet 
  64.     or fidonet addresses.
  65.  
  66.     - Sysops using Fidonet<->Internet gateways can have the gateway address 
  67.     automatically appended to the end of users internet addresses.  EASY 
  68.     ADDRESS automatically determines if the address is an internet address. 
  69.     Therefore eliminating the need to highly modify the baja code, or explain 
  70.     to a user that they need to address their internet messages to UUCP@1:1/31.
  71.     e.g. the user's internet address they are sending a message to with the 
  72.     appended GUUCP address  will look like: 
  73.     gregory.campbell@f8047.n124.z1.fidonet.org @1:1/31 
  74.     in the Synchroent To: field.
  75.     
  76.     Note: SysOps using NetXpress (SynchUUCP) will have their NetMail messages 
  77.     correctly addressed (without the gate address referred to above) and 
  78.     SysOps with no internet access will be able to use EASY ADDRESS for 
  79.     fidonet and QWK mail only.          
  80.  
  81.     Note: If you currently do not have internet E-mail on your system, enter 
  82.     the address 1:1/31 for the GUUCP gateway, and you will have it 
  83.     automatically.  This is a GUUCP gate available to ALL fidonet systems.
  84.     Your users address will be of the form:
  85.     first.last@f[node]n[net]z[zone]p[point].fidonet.org 
  86.      [point], [node], [net], and [zone] are your fidonet address.
  87.  
  88.     - Each user has his/her individual address book, and the only limit on 
  89.     the number of addresses is memory requirements.  Users are warned if 
  90.     there is not enough memory to add another address and EASY ADDRESS 
  91.     will not lock the system if it runs out of memory.
  92.  
  93.     - Users are able to add addresses (including a note about the address)
  94.     to their list, delete addresses from edit addresses and scan their 
  95.     address book quickly and efficiently.
  96.  
  97.     - Easy Address performs it's own maintenance and can tell when a user's 
  98.     name has changed.  If the user's name has changed (like a new user takes 
  99.     an old slot) a new address file is automatically created for the new user.
  100.  
  101.     - Easy Address has support for internet (NetXpress only) and fidonet
  102.     file attaches. 
  103.     
  104.     - There is an Online help screen for users.  This explains what Easy 
  105.     Address is, how to use it, and it shows them their personal fidonet,
  106.     internet and QWK addresses on your system.
  107.  
  108.     - The sysop can customize the colors in Easy Address by changing the    
  109.     Ctrl-A codes in the EASYCOLR.DAT file.  See the file for documentation
  110.     on the colors.  If you mess it up, just delete it and a new one will be
  111.     created with the default colors.
  112.  
  113.     - SysOps may place their systems fidonet, internet and QWK addresses in
  114.     the EASYCOLR.DAT file so users will be shown their personal address.
  115.  
  116.     - EASY ADDRESS will time out users if they run out of time on the BBS 
  117.     while in the EASY ADDRESS program or if they drop carrier.  
  118.  
  119.     - EASY ADDRESS uses the XSDK 2.24 and therefore allows users to see
  120.     who is online while in Easy Address and send messages to other nodes.
  121.  
  122.     - This program does not allow duplicate messages in the address list of a
  123.     user.
  124.     
  125.     - EASY ADDRESS supports both ANSI and ASCII, reads user and SysOp 
  126.     information from the XTRN.DAT file in the node directory, and creates 
  127.     individual database files for each user in its own directory.
  128.  
  129.     - Registered versions will not have all the UNREGISTERED flags, and will 
  130.     show todays date and time where the UNREGISTERED prompt is.
  131.  
  132.  
  133.     To set up EASY ADDRESS follow the instructions given below.  They include 
  134.     setting up the the SCFG configuration, and modifying the BAJA source code
  135.     for each module that you will use EASY ADDRESS with.  
  136.  
  137.     NOTE: Easy Address requires BAJA.EXE to be in the EXEC directory  
  138.     
  139.     NOTE: If you are upgrading from version 1.0 see the file UPGRADE.DOC
  140.  
  141.     1. Create a directory for EASY ADDRESS
  142.         e.g. mkdir c:\sbbs\xtrn\easyadd <ENTER>
  143.  
  144.     2. Copy ALL of the archive files to this directory.
  145.         e.g. copy *.* c:\sbbs\xtrn\easyadd <ENTER>
  146.  
  147.     3. Modify each of your BAJA source files as follows: 
  148.         
  149.         Replace the command MAIL_SEND_NETMAIL with:
  150.             EXEC_XTRN EASYADD
  151.             EXEC *EASY%#
  152.         
  153.         and replace the command MAIL_SEND_NETFILE with:
  154.             EXEC_XTRN EASYADDF
  155.             EXEC *EASY%#
  156.     
  157.     4. Compile the modified source files
  158.         e.g. BAJA DEFAULT.SRC <ENTER>
  159.  
  160.     5. Go into SCFG->External Programs->External Programs and add two
  161.     external programs (EASYADD and EASYADD, see example below) to 
  162.     your external program groups.  
  163.     
  164.     Note: The command line options must be in ORDER, and ALL five must be 
  165.     present.  The following explains the command line parameters, and can 
  166.     be viewed by typing EASYADD without any parameters.
  167.  
  168.     The required line parameters are:
  169.     1- %! (The full path to the exec directory)
  170.     2- EMAIL or FILE (use FILE for file attach option, otherwise use EMAIL)
  171.     3- Registration code (Use 000000 if unregistered)
  172.     4- Internet option (Full GUUCP address, SUUCP or NONE) Use SUUCP if you
  173.         have NetXpress
  174.     5- Time Zone value (e.g. TZ=CST6EDT)
  175.  
  176.         e.g. EASYADD %! EMAIL 000000 1:1/31 TZ=CST6EDT
  177.  
  178.     NOTE: You should set the TZ environmental variable to the difference 
  179.     between local time and GMT.   This is the same variable used by TICK 
  180.     and many other bbs-related programs. For the Eastern time zone,  it 
  181.     would be set to TZ=EST5EDT.  Central Time Zone is TZ=CST6EDT, and 
  182.     Pacific is PST8EDT.  
  183.  
  184.     The following are example command lines used for EASY ADDRESS:
  185.  
  186.     EMAIL option, UNREGISTERED, GUUCP gate address 1:1/31, and the
  187.         Central Time Zone
  188.  
  189.         EASYADD %! EMAIL 000000 1:1/31 TZ=CST6EDT
  190.  
  191.     EMAIL option, UNREGISTERED, no internet mail allowed and the
  192.         Eastern Time Zone
  193.  
  194.         EASYADD %! EMAIL 000000 NONE TZ=EST5EDT
  195.  
  196.     EMAIL option, UNREGISTERED, NetXpress (SynchUUCP) and 
  197.         Pacific Time Zone
  198.  
  199.         EASYADD %! EMAIL 000000 SUUCP TZ=PST8EDT
  200.  
  201.     FILE attach option, UNREGISTERED, NetXpress (SynchUUCP) and 
  202.         Pacific Time Zone
  203.  
  204.         EASYADD %! FILE 000000 SUUCP TZ=PST8EDT
  205.  
  206. This is the EASYADD External Programand allows Easy Address to work
  207. correctly when sending NetMail.
  208.  
  209. Note: You must use the same internal code as shown in the following setup:
  210. +[_][?]----------------------------------------------------+
  211. ª                          EASYADD                         ª
  212. ª----------------------------------------------------------ª
  213. ª ªName                       EASYADD                      ª
  214. ª ªInternal Code              EASYADD                      ª
  215. ª ªStart-up Directory         C:\SBBS\XTRN\EASYADD         ª
  216. ª ªCommand Line               EASYADD %! EMAIL 000000 1:1/31 TZ=CST6EDT ª
  217. ª ªClean-up Command Line                                   ª
  218. ª ªCost in Credits            0                            ª
  219. ª ªAccess Requirements        LEVEL 99                     ª
  220. ª ªExecution Requirements                                  ª
  221. ª ªMultiple Concurrent Users  Yes                          ª
  222. ª ªIntercept I/O Interrupts   Yes -> NO to WWIV            ª
  223. ª ªSwap BBS out of Memory     Yes                          ª
  224. ª ªModify User Data           No                           ª
  225. ª ªExecute on Event           No                           ª
  226. ª ªBBS Drop File Type         Synchronet      XTRN.DAT     ª
  227. ª ªPlace Drop File In         Node Directory               ª
  228. +----------------------------------------------------------+
  229.  
  230. This is the EASYADDF External Program and allows Easy Address to work
  231. correctly with File Attaches.
  232.  
  233. Note: You must use the same internal code as shown in the following setup:
  234. +[_][?]----------------------------------------------------+
  235. ª                          EASYADDF                        ª
  236. ª----------------------------------------------------------ª
  237. ª ªName                       EASYADDF                     ª
  238. ª ªInternal Code              EASYADDF                     ª
  239. ª ªStart-up Directory         C:\SBBS\XTRN\EASYADD         ª
  240. ª ªCommand Line               EASYADD %! FILE 000000 1:1/31 TZ=CST6EDT ª
  241. ª ªClean-up Command Line                                   ª
  242. ª ªCost in Credits            0                            ª
  243. ª ªAccess Requirements        LEVEL 99                     ª
  244. ª ªExecution Requirements                                  ª
  245. ª ªMultiple Concurrent Users  Yes                          ª
  246. ª ªIntercept I/O Interrupts   Yes->NO to WWIV              ª
  247. ª ªSwap BBS out of Memory     Yes                          ª
  248. ª ªModify User Data           No                           ª
  249. ª ªExecute on Event           No                           ª
  250. ª ªBBS Drop File Type         Synchronet      XTRN.DAT     ª
  251. ª ªPlace Drop File In         Node Directory               ª
  252. +----------------------------------------------------------+
  253.  
  254.  
  255.     6. All Done setting up, now go into Synchronet and be AMAZED when you 
  256.     type N to send NetMail from the E-Mail directory.
  257.  
  258.     Hit H for help, for an explanation of all the commands
  259.  
  260.     You should be presented with a screen similiar to the following:
  261.  
  262.  
  263.                 Easy Address Version 2.0
  264.             Copyright 1994 G.A.C. Computer Services
  265.  
  266. This program is UNREGISTERED, please encourage Gregory (The Tramp) Campbell
  267. of The DogHouse BBS Test Center to register!
  268.  
  269.  ---------------------------------------------------------------------------- 
  270. | Num | Internet or Fidonet style address (e.g. Gregory Campbell@1:124/8047) |
  271. |-----|----------------------------------------------------------------------|
  272. |  0  | Gregory Campbell@1:124/804 | Note: Author's fidonet address          |
  273. |  1  | gregory.campbell@f8047.n12 | Note: Author's Internet address         |
  274. |  2  | Empty                      | Note: None                              |
  275. |  3  | Empty                      | Note: None                              |
  276. |  4  | Empty                      | Note: None                              |
  277. |  5  | Empty                      | Note: None                              |
  278. |  6  | Empty                      | Note: None                              |
  279. |  7  | Empty                      | Note: None                              |
  280. |  8  | Empty                      | Note: None                              |
  281. |  9  | Empty                      | Note: None                              |
  282.  ---------------------------------------------------------------------------- 
  283. Beginning, More, Add, Delete, Edit address 0-9 or Other, Quit or Help
  284.  
  285.  
  286. Of course if you are using ANSI the screen is in color.  Do me a favor and 
  287. use 0 or 1 and send me a message telling me that you are using EASY ADDRESS 
  288. and what you like or may not like about it.
  289.  
  290.  
  291. ┌───────────────────────────────────────────────────────────────────────────┐
  292. │                    Registration and technical support                     │
  293. └───────────────────────────────────────────────────────────────────────────┘
  294.  
  295.     Registration cost is $20.00 U.S. for EASY ADDRESS.  The fee will be 
  296.     used to help me develop larger and better Synchronet programs.  
  297.     
  298.     Print the file REGISTER.DOC, fill it out and send it along with a 
  299.     check or money order for $20.00 U.S. to:
  300.  
  301.         Gregory Campbell
  302.         G.A.C. Computer Services
  303.         2040 Spring Creek Parkway Suite 141238
  304.         Plano, TX 75023-4225
  305.  
  306.     If you would like more information on how to use EASY ADDRESS or have 
  307.     a problem with it, you may contact me in the following ways.
  308.  
  309.      Call me voice:             214-517-3692 (10am-10pm CST)
  310.      Call my BBS:               214-527-6811
  311.      Send me NetMail:           Gregory Campbell@1:124/8047
  312.      Send me Internet E-mail:   Gregory.Campbell@f8047.n124.z1.fidonet.org
  313.      Send me QWK NetMail:       The.Tramp@DOGHOUSE
  314.  
  315.      Or Ask me a question in DOVE-Net, my Alias is The.Tramp
  316.  
  317.     To obtain the newest public release versions of Easy Address
  318.     FREQ EASYADD from 1:124/8047 or call my BBS and login as Guest
  319.  
  320.  
  321.  
  322.